package com.tianji.learning.service;

import com.tianji.common.domain.dto.PageDTO;
import com.tianji.common.domain.query.PageQuery;
import com.tianji.learning.domain.po.LearningLesson;
import com.baomidou.mybatisplus.extension.service.IService;
import com.tianji.learning.domain.vo.LearningLessonVO;
import com.tianji.learning.domain.vo.LearningPlanPageVO;

import java.util.List;

/**
 * <p>
 * 学生课程表 服务类
 * </p>
 *
 * @author XinxuanZhuo
 * @since 2024-02-05
 */
public interface ILearningLessonService extends IService<LearningLesson> {

    /**
     * 接收到Mq下单通知后，添加课程到我的课表
     */
    void addUserLessons(Long userId, List<Long> courseIds);

    /**
     * 分页查询我的课表
     */
    PageDTO<LearningLessonVO> queryMyLessons(PageQuery query);

    /**
     * 查询用户当前正在学习的课程
     */
    LearningLessonVO queryMyCurrentLesson();

    /**
     * 接收到Mq退款通知后，将课程从我的课表中删除
     */
    void deleteUserLesson(Long userId, List<Long> courseIds);

    /**
     * 根据课程id，检查当前用户的课表中是否有该课程，课程状态是否有效。
     */
    Long isLessonValid(Long courseId);

    /**
     * 根据课程id，查询当前用户的课表中是否有该课程，
     * 如果有该课程则需要返回课程的学习进度、课程有效期等信息。
     */
    LearningLessonVO queryLessonByCourseId(Long courseId);

    /**
     * 统计课程学习人数
     */
    Integer countLearningLessonByCourse(Long courseId);

    /**
     * 根据用户id和课程id查询课表
     */
    LearningLesson queryByUserIdAndCourseId(Long userId, Long courseId);

    /**
     * 创建学习计划
     */
    void createLearningPlan(Long courseId, Integer freq);

    /**
     * 查寻学习计划进度
     */
    LearningPlanPageVO queryMyPlans(PageQuery query);
}
